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About This Book 


This book will help you diagnose problems in the availability manager component. 
Using the book, you will be able to: 


¢ Follow diagnostic procedures for each type of problem in the component 
¢ Collect and analyze data needed to diagnose the problem | 


¢ Develop a search argument to be used for searching problem reporting data 
bases 


¢ Know what problem data is needed before reporting the problem to IBM 


Trademarks 


The following are trademarks of International Business Machines Corporation: 


¢ MVS™ 
¢ MVS/ESA™ 


Who This Book Is For 
This book is for anyone who diagnoses problems that appear to be caused by the 
availability manager. 
The level of detail at which this book is written assumes that the reader: 


e Understands the commonly used diagnostic tasks and aids, such as those pre- 
sented in the Basics of Problem Determination book 


* Codes in assembler language, and reads assembler and linkage editor output 
e Understands basic system concepts and the use of system services 


e Understands the externals for the availability manager 


How This Book Is Organized 
This book contains the following: 


¢ Chapter 1, “Diagnosing Problems in Availability Manager” identifies the 
problem types and gives a diagnostic procedure for each type. 


¢ Chapter 2, “Collecting and Analyzing Problem Data for Availability Manager” 
tells how to collect and analyze needed problem data. 


e Chapter 3, “Developing a Search Argument for Availability Manager” summa- 
rizes the search argument symptoms for problems in the availability manager. 


¢ Chapter 4, “Reporting a Problem to IBM” summarizes the problem data 
needed for reporting the problem to IBM. 


e Chapter 5, “Introduction to Availability Manager” provides an overview of the 
services performed by the component and the expected inputs and outputs. 


e “Index.” 
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Related Information 


Where necessary, this book references information in other books, using shortened 
versions of the book title. The following figure shows the shortened titles, complete 
titles, and order numbers of the books you might need while you are using this 
book. 


Order 
Number 


Recovery Facility (XRF) 


Service Aids | MVS/ESA Service Adis 
System Codes MVS/ESA Message Library: System Codes GC28-1815 


System Messages MVS/ESA Message Library: System Messages, GC28-1812 
Volumes | - 2 and 
GC28-1813 


Using Dumps and Traces MVS/ESA Diagnosis: Using Dumps and Traces LY 28-1843 


MVS/Extended Architecture Planning: Extended 
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Diagnosis Library 


PLANNING: 


Planning: 
Dump and 
Trace 

Services 


GC28-1838 GC28-1832 


DIAGNOSIS: 


For Diagnostic Procedures 


SYS1LIOGREC 
Error 


Diagnosis: 
Using 
Dumps and 
Traces 


Command 


Recording Reference 


LY2B8-1843 GC28-1844 GC2B~-1B45 GC28-1834 


For Data Interpretation 


Diagnosis: Diagnosis: Dump System 
Dato Areas System Output Messages 
Reference Messages Hateareds 


GC28-1812 
& 
GC28-1813 


LY28-1043 
to 


LY28-1047 


Microfiche 


GC?8- 1814 


LYBB-xxxx 


LY28-1011 


For Component-Specific Information 
(To identify the component, see Basics of Problem Determination) 


Component 
Diagnosis: 


Component 
Diagnosis: 
XYZ 


Module 
Descrip- 
tions 
LY28-1420 


IY2B- xxxx 
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Summary of Changes 


Summary of Changes 
for LY28- 1438-1 
MVS/System Product Version 3 Release 1.3 


Changed Information: Various technical and editorial changes were made 
throughout the book. 


Summary of Changes 
for LY28- 1438-0 | 
MVS/System Product Version 3 Release 1.0 


This book contains information presented in MVS/Extended Architecture System 


Logic Library: Availability Manager, LY28-1625-0. This book contains no new tech- 
nical information. 
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Chapter 1. Diagnosing Problems in Availability Manager 


Prerequisites 


Before using this book, collect the following problem data. If you do not have 
this data, see the Basics of Problem Determination book and perform its proce- 
dures. 


¢ The problem type, such as an abend 
¢ The product name 
¢ The component name: availability manager 


Use this book to diagnose problems only in the availability manager. If the 
component name is not availability manager, return to the Basics of Problem 
Determination book to identify the component. Use the component diagnosis 
book for the identified component. 


Identifying Problems 


The following figure lists the symptoms that indicate each problem type. The figure 
directs you to a diagnostic procedure for that problem type or to another book. 


For a problem with these symptoms: See the following: 


Abend X'02E': The availability manager terminates with “Diagnosing an Abend 
system completion code X '02E'. The second byte of reg- O2E” on page 1-2 
ister 15 contains one of the following reason codes: 


System completion code 
O2E in System Codes 


Abend X'02E'for a user problem: The availability 
manager terminates with system completion code 
X'O2E'. The reason code in register 15 is not listed 
above. This is a user problem. 


Message AVM032I, AVM034I, AVYMO036I, or AVM038I 


Message AVMnnns other than a listed message 


Figure 1-1. Problem Types 


“Diagnosing Message 
AVM032I, AVMO34I, 
AVM036I, or AVMO038I” 
on page 1-3 


System Messages for the 
| message explanation | 
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Diagnosing an Abend 02E 


Use this procedure if the availability manager abnormally terminates with system 
completion code X'02E'. The second byte of register 15 contains one of the fol- 
lowing reason codes: 


01 
03-11 
13-17 
1A-27 
29 
2C-33 
38 
3A-47 
49 


Diagnostic procedure 


References 


System Messages for 
explanation of the mes- 


. Obtain message AVMOIOE and other messages 
accompanying abend X'02E'. Look at their expla- 


Figure 


1-2 Comp Diag: AVM 


nations and take any recommended actions. 


. Obtain the SYSI1.LOGREC error record or the 
dump for the abend. An SVC dump for the abend 
has a title beginning with COMPON=AVM. 


. Format the dump or SYS1.LOGREC record to see 
the search argument: 


¢ Format an SVC dump or SYSMDUMP 
ABEND dump with the IPCS VERBEXIT 
LOGDATA subcommand. 

¢ Format a SYS1.LOGREC record with EREP to 
obtain a detail edit report. 


. Develop a search argument consisting of: 


¢ CSECT name: RIDS/AVFccccc 
¢ System abend code: AB/SOO2E 

¢ Abend reason code: PRSC/hh 

¢ Message identifier: MS/AVMOIL0E 


. Use the search argument to search problem 
reporting data bases. If the search finds that the 
problem has been reported before, request the 
problem fix. If not, continue with the next step. 


. From the SVC dump, obtain information about the 
availability manager using the IPCS VERBEXIT 
AVMDATA subcommand. 


. Report the problem to IBM, if assistance is needed. 
Provide the following problem data: 


¢« Accompanying messages 

¢ The dump and/or SYS].LOGREC error record 
¢ The search argument 

¢ Product name 

¢ Module level 


1-2. Diagnostic Procedure for an Abend 02E 


sages 


Using Dumps and Traces 
for an explanation of the 
dump title 

IPCS Command Refer- 
ence for the subcommand 


EREP User's Guide for 
EREP formatting 


Chapter 3, “Developing a 
Search Argument for 
Availability Manager” 


Chapter 2, “Collecting 
and Analyzing Problem 
Data for Availability 
Manager” 


IPCS Command Refer- 
ence for the subcommand 


Chapter 4, “Reporting a 
Problem to IBM” 
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Diagnosing Message AVM032I, AVM034I, AVMO036I, or AVMO038I 


Use this procedure if the availability manager issues message AVM032I, AVM034I, 
AVMO036I, or AVMO38I. 


1. Obtain any variable data from the text of the System Messages for a 
message. description of the message 
text 


2. Develop a search argument consisting of: Chapter 3, “Developing a 
Search Argument for 


ec Vieosabe sdenulien, Availability Manager” 


MS/AVM032I 
MS/AVMO034I 
MS/AVMO036I 
MS/AVMO038I 

¢ Reason code: PRCS/hh 


3. Use the search argument to search problem 
reporting data bases. If the search finds that the 
problem has been reported before, request the 
problem fix. If not, continue with the next step. 


4. Report the problem to IBM, if assistance is needed. Chapter 4, “Reporting a 
Provide the following problem data: Problem to IBM” 


¢ The search argument 


* Product name 
| ¢ Message identifier and text | | 
Figure 1-3. Diagnostic Procedure for Message AVM032I, AVMO34I, AVMO36I, or 
AVMO38I 
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Chapter 2. Collecting and Analyzing Problem Data for 
Availability Manager 


This chapter contains information to help you collect and analyze data about a 
problem. 


Dumping Availability Manager Data 


A dump for availability manager contains diagnostic data. Format the diagnostic 
data using IPCS. For information about IPCS, see JPCS User's Guide and [PCS 
Command Reference. Obtain availability manager diagnostic data as follows: 


1. Start an IPCS session. 
2. Select the COMMAND option on the IPCS Primary Option Menu. 
3. Enter the following subcommand on the IPCS Subcommand Entry panel: 


VERBEXIT AVMDATA 


The state of the availability manager and associated subsystems determines the 
control blocks printed for the subcommand. 


On the following page is an example of an output of the subcommand. 


LY28-1438-1 © Copyright IBM Corp. 1988,1990 2-1 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


EPS eee ES AVM DATA FOLLOWNS Pe Se EEE SF 
AVVT OOB3EFEO 
+0000 ID CLESESES LEN 0020 SP OOF! LEVL 00000001 AVMN OLDESBAS 
+0010 [RQ CISC5BFO] GLUE 80FE4A20 TRM 81DE1D50 RSV 00000000 
AVMN = O1DESBA8 
+0000 ID CLESD4D5_ LEN 0458 SP O0E7 LEVL 00000001 STAT 00000006 
#0010 ASCB 00F43100 ASID oo0c GENR 0007 CAUS 00 RSV 000000 
+001C TDOM 00000000 CHPF 00 CuPC 000000 RScD 00000000 DQ 00000000 
#002C AVAS O1DE5808 STKN 00000001 ETKN 00000u0L ATKN 00000001 RSV 0000 
+003E IDTN 0680 RSV 0000 MHSP OOF1 MHSZ OO0071A8 MHPT O1DDDES8 
#004C IDTS O1DESCOO OFLW 0000 MGEN 0000 RSV 00000000 
ASID TABLE 
+0058 AS 00B GEN 0000 RSV 00 USE 003E80 
#0050 AS 0000 GEN 0000 RSV 00 USE 000000 
#0053 AS 0000 GEN 0000 RSV 00 USE 000000 
+0070 AS 0000 GEN 0000 RSV 00 USE 000000 
#0078 AS 0000 GEN 0000 RSV 00 USE 000000 
#0080 AS 0000 GEN 0000 RSV 00 ees 
+0088 AS 0000 GEN conn nae 
+0090 AS 000n ao 
ennoe + 
SE 000000 
U 
ne See ovuu RSV 00 USE 000000 
vuuo GEN 1000 RSV 00 USE 000000 
#0440 AS 0000 GEN 0000 RSV 00 USE 000000 
#0448 AS 0000 GEN 0000 RSV 00 USE 000000 
#0450 AS 0000 GEN 0000 RSV 00 USE 000000 
+++ AVM REQUEST QUEUE +t++ 
AVTA O1BCS5SBFO 
[Avra _a1pesaro | C1E5E3C1 LEN 0026 SP O0E7 LEVL oo0000001 [Nex O1BC5C58 
#0010 SRB Q1BC6ACO RGTY 02000000 ROP 00000000 ASID 0003 RSV 0 
+0020 ETKN 00000001 BLEN 0100 
SRB O1BC6ACO 
+0000 ID SRB FLNK 00000000 ASCB QOFSD880 CPAFF 0000 PASID 0008 
+0010 PTCB 00000000 EPA 8100D700 RMTRA 81000760 PARM O1BCSBBO SAVE 00000000 
40024 PKF 00 FLGS 00 HLH 00 FLGS1 00 FRRA 00000000 
AVTD O1BC5BBO 
+0000 ID C1ESE3C4 LEN O03E SP Q0E7 LEVL 00000001 RQTY 02000000 
| #0010 SKEY 00000080 ECB 00006E78 STAT 00006E94 ASPR 00F4D880 ASCB 00F4DS880 
| #0024 TCB 00000000 RB 00000000 FLAG 30000000 ASID 000B GEN 0000 
| +0034 INDX 00000001 RBUF OO00KEA? BLEN noo 
| 
+0000 «ID C1E5E3C1 LEN 0026 SP 00E7 LEVL 00000001 
+0010 SRB OIBC6AFO RQTY 02000000 RQOP 00000000 ASID 000B RSV Dh: 
+0020 ETKN 00000001 BLEN 0100 
! SRB OLBC6AFO 
++++ AVM UTILITY DATA REPOSITORY ++++ 
AVUD O1BFO1E0 
+0000 ID C1lESEGC4 SP 00E7 LEN 0584 LEVL 00000001 ¢Pss 00000008 
+0010 PSSD O1BF0204 RSE 00000004 RSED O1BF0404 SSE 00000008 SSED 01BFO04C4 
PSSD 01BF0204 
+0000 ID D7EZE2C4 LEN 0040 RSV 0000 LVL 00000001 TOKN 00000001 
+0010 SLNK O1BF04C4 ASID 000B FLG 0000 SIDL 04 SIDN SUBA 
+0029 ASD2 0008 MSGL 04 MSGN SUBA STRM ooco0000 
SSED O1BFO4C4 
+0000 ID E2E2C5C4_ LEN 0058 RSV 0000 LVL 00000001 ETOK 00000001 
#0010 ATOK 00000001 STOK 00000001 IOPD 00000000 RSV 00000000 PMID 00000000 
+0024 ENID 00000000 ECB 00000000 RLNK O1BF0404 PLNK O1BF0204 GTRQ O1BFO148 
+0038 STAT 08000000 IOST 04000000 FLGS 00000000 MODE 80 RSV 0000 
+0047 RSEL 04 RSEN RSEl 
GRQH O1BFO148 
+0000 ID C7D9D8C8 LEN 0018 sP O0E7 LEVL 00000001 FRST O1BFOOEO 
+0010 LAST O1BFOOEO RSV 00000000 
GRQE O1BFOOED 
+0000 ID C7D9D8C5_ LEN 002D sP O0E7 LEVL 00000001 NEXT 01BF0148 
+0010 PREV O1BF0148 TYPE 01 RSV 000000 AVTA 00000000 RCRD 00110009 occ0000! 
+0024 C1lESD4D5 D6C3D6D4 D4 
RSED 01BF0404 
+0000 ID DIEZCSC4 N DO3E RSV 0000 LVL 00000001 BF04C4 
+0010 BCK 7FFFFFFF (STAT 40000000] RSV 000000 RSEL 04 
+002C SCNT Qoun000l 
HEH IE HE HE HK HEE END OF AVM DATA HE HE HEE HE DE HE EE 


Figure 2-1. AVM Data 
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Chapter 3. Developing a Search Argument for Availability 


Manager 


Search procedures and arguments are described in the Basics of Problem Determi- 
nation book. 


The following figures show symptoms for search arguments for this component. 
The first figure summarizes the symptoms recommended 1n the diagnostic proce- 


dures in Chapter 1, “Diagnosing Problems in Availability Manager” on page 1-1. 
The second figure lists symptoms to add if the searches produce too many matches. 


iin Structured Format Psa 
Description Free Format Symptom Examples 
Symptom 
CSECT name AV Fccccc RIDS/AVFccccce AVFED 
System abend hhh AB;SOhhh 02E 
a 
Abend reason hh PRCS /hh 01 


code 
msgA VM032I 
MS/AVM032!] 


Reason code from RChh PRCS /hh rc08 
the message text PRCS/08 


Figure 3-1. Search Arguments 


MS/cccnnns 


Message identifier msgcccnnns 


Structured Format 
Symptom 


Free Format Examples 


Symptom 


Program identifier 5752SCccc PIDS/5752SCccc S725SCAVM 
PIDS/5725SCAVM 


Other search argu- 
ments developed 
while using the 
Basics of Problem 
Determination 
book 


Figure 3-2. Additional Search Arguments 


Description 
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Chapter 4. Reporting a Problem to IBM 


The checklist in the following figure identifies the data that IBM needs for a 
problem in the availability manager. Collect the data appropniate for the problem 
type before calling to report a problem. 


Search argument from Chapter 3, “Developing a 
Search Argument for Availability Manager” 


Product name, version, and release MVS/System Product 
3.1 


Module level Product level: HBB3310 


Program temporary fix 


(PTF) number: 
UY00934 


SVC dump including AVMDATA output 


| Messages accompanying the problem, including the Identifier: AVM032I 
message identifier and text 


Other problem data developed while using the | 
Basics of Problem Determination book 


Figure 4-1. Checklist of Problem Data 
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Part 2. Reference for Availability Manager 
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Chapter 5. Introduction to Availability Manager 


The availability manager enhances the operating system’s support for subsystem 
availability. It defines and manages the recoverable service elements (RSEs) in an 
Extended Recovery Facility (XRF) complex. XRF is a related set of programs that 
allows an installation to achieve a high level of availability for selected end users. In 
particular, it responds to the Information Management System/Virtual Storage 
(IMS/VS) users’ need for continuity of online transaction processing. The related set 
of IBM software products that work together to make up XRF are: 


¢ MVS/System Product and Data Facility Product 

¢ IMS 

e Virtual telecommunications access method (VTAM) 

¢ Network control program (NCP), including system support program (SSP) 


They run on an IBM processor to provide end users with improved reliability and 
continuity of service. To understand the larger context in which availability 
manager operates, see Planning: XRF. 


The modules in the availability manager component are named AVFccccc. 
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